Skip to content

docs: Add documentation regarding HybridSDK target removal#7024

Merged
philprime merged 3 commits intomainfrom
itay/decision_hybrid_sdk
Feb 4, 2026
Merged

docs: Add documentation regarding HybridSDK target removal#7024
philprime merged 3 commits intomainfrom
itay/decision_hybrid_sdk

Conversation

@itaybre
Copy link
Contributor

@itaybre itaybre commented Dec 10, 2025

This decision documents the removal of the HybridSDK subspec and module, consolidating all hybrid APIs into the main Sentry target.

Background

Until v9.1.0, we maintained a separate SDK variant with additional public headers/APIs for downstream SDKs (React Native, Flutter, .NET, SwiftUI). This separation:

  • Required maintaining multiple distribution variants
  • Increased CI complexity and team workload
  • Provided no real protection (users could still access "internal" APIs by switching dependencies)

Decision

Remove the HybridSDK submodule and subspec, treating hybrid SDK consumers as first-class citizens by:

  • Exposing required APIs in a documented manner
  • Avoiding breaking changes to these APIs in minor versions
  • Using naming conventions to distinguish internal APIs from user-facing ones

Next Steps

  1. Consolidate headers into the main target and remove HybridSDK subspec, done in chore: Removes HybridSDK subspec #7019
  2. Update downstream SDKs
  3. Align on an API naming convention (gather input from other SDK maintainers)

Copy link
Member

@philipphofmann philipphofmann left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks

itaybre and others added 2 commits December 11, 2025 11:51
Co-authored-by: Philipp Hofmann <philipp.hofmann@sentry.io>
@itaybre itaybre added the ready-to-merge Use this label to trigger all PR workflows label Dec 12, 2025
@itaybre itaybre marked this pull request as ready for review December 12, 2025 16:25
@itaybre
Copy link
Contributor Author

itaybre commented Feb 3, 2026

We have already removed HybridSDK subspec, we can merge this doc update.

@philprime philprime merged commit 4402b70 into main Feb 4, 2026
167 of 178 checks passed
@philprime philprime deleted the itay/decision_hybrid_sdk branch February 4, 2026 08:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ready-to-merge Use this label to trigger all PR workflows

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants